<!DOCTYPE html>
<html>
<head>
  <meta charset="utf-8">
  <title>接口编辑 - 接口管理 - DOClever 移动时代首选接口管理平台！</title>
  <meta name="description" content="现在我们再次打开刚才我们创建的接口，来详细的给大家说明下如何去编辑一个接口">
  <meta name="keywords" content="接口">
  <meta name="renderer" content="webkit">
  <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
  <meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1">
  <link rel="stylesheet" href="../style/css/layui.css"  media="all">
  <link rel="stylesheet" href="../style/style.css"  media="all">
</head>
<body>
<div id="page-container" class="help">
	<div class="curve2" style="background: url('../style/back.jpg') no-repeat scroll center center / cover border-box, rgba(0, 0, 0, 0) linear-gradient(60deg, rgb(23, 185, 230) 0%, rgb(23, 230, 126) 100%) repeat scroll 0% 0%;padding-bottom: 150px">
		<div class="layui-container">
			<ul class="layui-nav" lay-filter="" style="background: none">
			  <li class="layui-nav-item"><a href="/"><h2 style="font-size: 32px">DOClever</h2></a></li>

			</ul>
		</div>
	</div>
	<div class="layui-container bd">
		<div class="layui-tab layui-tab-brief">
		  	<ul class="layui-tab-title">
		  										<li ><a href="../../ksks/" >快速开始</a></li>
								<li  class="layui-this" ><a href="../../xxsy/" >详细使用</a></li>
								<li ><a href="../../xxbs/" >线下部署</a></li>
								<li ><a href="../../bbgx/" >版本更新</a></li>
								<li ><a href="../../changjian/" >常见问题</a></li>
								<li ><a href="../../log/" >更新日志</a></li>
				 
						  	</ul>
		</div>  
	  	<div class="layui-row layui-col-space30">
		    <div class="layui-col-md3 left ">    
				<div class="layui-collapse" lay-accordion="">
															<div class="layui-colla-item">
					    <h2 class="layui-colla-title">基础</h2>
					    <div class="layui-colla-content " >
					    															<p style="padding: 5px 0 5px 15px"><a href="../../xxsy/jichu/2.html" >注册登录</a></p>
														<p style="padding: 5px 0 5px 15px"><a href="../../xxsy/jichu/27.html" >修改资料</a></p>
														<p style="padding: 5px 0 5px 15px"><a href="../../xxsy/jichu/28.html" >导入项目</a></p>
														<p style="padding: 5px 0 5px 15px"><a href="../../xxsy/jichu/29.html" >项目分类</a></p>
														<p style="padding: 5px 0 5px 15px"><a href="../../xxsy/jichu/54.html" >总后台管理</a></p>
																			    </div>
					</div>
										<div class="layui-colla-item">
					    <h2 class="layui-colla-title">接口管理</h2>
					    <div class="layui-colla-content layui-show " >
					    															<p style="padding: 5px 0 5px 15px"><a href="../../xxsy/jkgl/30.html" >分组操作</a></p>
														<p style="padding: 5px 0 5px 15px"><a href="../../xxsy/jkgl/31.html" >创建接口</a></p>
														<p style="padding: 5px 0 5px 15px"><a href="../../xxsy/jkgl/32.html" >接口编辑</a></p>
														<p style="padding: 5px 0 5px 15px"><a href="../../xxsy/jkgl/33.html" >接口管理</a></p>
														<p style="padding: 5px 0 5px 15px"><a href="../../xxsy/jkgl/34.html" >Inject注入</a></p>
																			    </div>
					</div>
										<div class="layui-colla-item">
					    <h2 class="layui-colla-title">接口调试</h2>
					    <div class="layui-colla-content " >
					    															<p style="padding: 5px 0 5px 15px"><a href="../../xxsy/jkts/35.html" >接口测试</a></p>
														<p style="padding: 5px 0 5px 15px"><a href="../../xxsy/jkts/36.html" >一键生成</a></p>
														<p style="padding: 5px 0 5px 15px"><a href="../../xxsy/jkts/37.html" >数据效验</a></p>
														<p style="padding: 5px 0 5px 15px"><a href="../../xxsy/jkts/38.html" >内网调试</a></p>
														<p style="padding: 5px 0 5px 15px"><a href="../../xxsy/jkts/39.html" >Mock数据</a></p>
																			    </div>
					</div>
										<div class="layui-colla-item">
					    <h2 class="layui-colla-title">全局设置</h2>
					    <div class="layui-colla-content " >
					    															<p style="padding: 5px 0 5px 15px"><a href="../../xxsy/qjsz/40.html" >状态码</a></p>
														<p style="padding: 5px 0 5px 15px"><a href="../../xxsy/qjsz/41.html" >全局环境注入</a></p>
														<p style="padding: 5px 0 5px 15px"><a href="../../xxsy/qjsz/42.html" >文档</a></p>
														<p style="padding: 5px 0 5px 15px"><a href="../../xxsy/qjsz/43.html" >环境变量</a></p>
																			    </div>
					</div>
										<div class="layui-colla-item">
					    <h2 class="layui-colla-title">项目设置</h2>
					    <div class="layui-colla-content " >
					    															<p style="padding: 5px 0 5px 15px"><a href="../../xxsy/xmsz/44.html" >项目信息</a></p>
														<p style="padding: 5px 0 5px 15px"><a href="../../xxsy/xmsz/45.html" >邀请成员</a></p>
														<p style="padding: 5px 0 5px 15px"><a href="../../xxsy/xmsz/46.html" >项目导出</a></p>
														<p style="padding: 5px 0 5px 15px"><a href="../../xxsy/xmsz/47.html" >团队申请</a></p>
																			    </div>
					</div>
										<div class="layui-colla-item">
					    <h2 class="layui-colla-title">自动化测试</h2>
					    <div class="layui-colla-content " >
					    															<p style="padding: 5px 0 5px 15px"><a href="../../xxsy/test/48.html" >简单测试</a></p>
														<p style="padding: 5px 0 5px 15px"><a href="../../xxsy/test/49.html" >高级测试</a></p>
														<p style="padding: 5px 0 5px 15px"><a href="../../xxsy/test/50.html" >组合测试</a></p>
														<p style="padding: 5px 0 5px 15px"><a href="../../xxsy/test/51.html" >后台轮询</a></p>
																			    </div>
					</div>
										<div class="layui-colla-item">
					    <h2 class="layui-colla-title">版本管理</h2>
					    <div class="layui-colla-content " >
					    															<p style="padding: 5px 0 5px 15px"><a href="../../xxsy/bbgl/52.html" >项目版本</a></p>
														<p style="padding: 5px 0 5px 15px"><a href="../../xxsy/bbgl/53.html" >接口快照</a></p>
																			    </div>
					</div>
										<div class="layui-colla-item">
					    <h2 class="layui-colla-title">团队协作</h2>
					    <div class="layui-colla-content " >
					    															<p style="padding: 5px 0 5px 15px"><a href="../../xxsy/tdxz/56.html" >创建团队</a></p>
														<p style="padding: 5px 0 5px 15px"><a href="../../xxsy/tdxz/57.html" >分配项目</a></p>
														<p style="padding: 5px 0 5px 15px"><a href="../../xxsy/tdxz/58.html" >管理组员</a></p>
														<p style="padding: 5px 0 5px 15px"><a href="../../xxsy/tdxz/59.html" >团队项目</a></p>
																			    </div>
					</div>
														</div>
			</div>
			<div class="layui-col-md9 right ">
				现在我们再次打开刚才我们创建的接口，来详细的给大家说明下如何去编辑一个接口<br />
<br />
<strong>基本信息</strong><br />
<br />
当我们鼠标放在基本信息旁边的小图标上时会显示，该接口的编辑信息，如下图<br />
<br />
<img alt="" src="" /><br />
<br />
<br />
这时我们再次打开刚才的接口会发现，基本信息一栏多出一个<span style="color:#ff0000;"><strong>&ldquo;分享&rdquo;</strong></span>栏，如下图所示：<br />
<br />
<img alt="" src="" /><br />
<strong>分享：</strong>是不可编辑的，可复制该分享链接给别的同事，分享生成的页面如下图：<br />
<br />
<img alt="" src="" /><br />
<br />
<br />
<br />
这里查看分享的信息如上图所示，可以查看该接口的详细信息！<br />
<br />
<strong>快照信息</strong><br />
<br />
再往下看，我们会发现跟新建接口时相比，多了一个<span style="color:#ff0000;"><strong>快照信息</strong></span>，如下图所示：<br />
<br />
<img alt="" src="" /><br />
<br />
在这里我们可以对我们的接口进行快照管理，当我们点击<span style="color:#40e0d0;"><strong>&ldquo;创建&rdquo; </strong></span>按钮时，会弹出如下窗口：<br />
<br />
<img alt="" src="" /><br />
<br />
我们点击保存即可为此接口创建了一个接口快照信息！<br />
<br />
下面我们在快照信息栏目，点击右侧的<span style="color:#40e0d0;"><strong>&ldquo;列表&rdquo; </strong></span>按钮，弹出如下窗口：<br />
<br />
<img alt="" src="" /><br />
<br />
在这里我们可以看到我们创建过的接口快照列表，在这里我们我们可以对接口快照进行：<br />
<strong>切换：</strong>切换快照状态<br />
<strong>回滚：</strong>回滚快照状态<br />
<strong>删除：</strong>删除当前选择的接口快照信息<br />
<br />
<strong>参数<br />
<br />
<img alt="" src="" /></strong><br />
<br />
接口参数栏目，可根据自己的接口的参数进行填写，在DOClever新版中我们会发现，参数栏目右侧会有个<img alt="" src="" />按钮，点击该按钮我们可以创建多个参数选项卡，具体如下图：<br />
<br />
<img alt="" src="" /><br />
<br />
我们点击后会发现多出了一个参数切换项。我们可以对这些参数选项卡进行<span style="color:#ff0000;"><strong>编辑以及克隆</strong></span>操作！<br />
<br />
对于很多接口，不同的入参会返回不同的出参，所以在DOClever里面，可以有多个入参出参的配对，每个配对可以称为一个参数实例。<br />
<br />
上图中<strong>&ldquo;参数&rdquo;</strong>就是一个参数实例，我们可以点击右边的加号来添加多个实例<br />
<br />
<img alt="" src="" /><br />
<br />
<strong>Param:</strong> 当我们在路径里面填写含有restful形式的url时，比如我把我们之前的接口路径改为：/user/info/{id},DOClever会自动解析路径，并且提供对param参数的支持，如下图<br />
<br />
<img alt="" src="" /><br />
<br />
<br />
<strong>Query:</strong> 这里代表的含义类似于http://aaa.com/user?name=sx&amp;pass=111 这个地址中的name=sx&amp;pass=111这样的参数，我们需要填入的是参数名称，参数是否必选，备注，参考值。点击未填值，弹出如下图所示：<br />
<br />
<img alt="" src="" /><br />
<br />
填入该参数的参考值和备注，点击保存
<p><strong>Header:</strong> 这里的含义代表我们发送该请求的自定义http头部</p>
<strong>Body:</strong> 当我们切换http method到post，put或者patch的时候，会出现Body这个标签页，我们切换到这个标签页，如下图：<br />
<br />
<img alt="" src="" /><br />
<br />
这里分为两种模式，一种是以键值对形式（key-value)，还有一种是把数据直接传给http body(raw)，当Header里面的content-type为空或者为application/x-www-form-urlencoded，multipart/form-data的时候，DOClever会切换为key-value的形式，其他情况会切换为raw。<br />
<br />
key-value：值得注意的是参数类型，可以有文本和文件两种，当选择文件的时候，DOClever会切换到multipart/form-data的方式发送数据。<br />
<br />
raw：我们可以现在不同的数据类型，选择不同的类型header里面的content-type也会发生相应的变化，当现在JSON的时候，会出现如下图所示的界面：<br />
<br />
<img alt="" src="" /><br />
<br />
JSON的具体操作会在出参里面做具体讲解
<p><strong>Inject:</strong> 这一部分在注入里面做详细讲解</p>
<strong>Result:</strong> 这里代表的是出参的数据模型，出参也分为两种，JSON，RAW。<br />
<br />
<strong>JSON：</strong>这里又分为Object和Array两种类型，Object代表返回的是一个json对象，Array代表返回的是一个json数组，参数字段从左到右依次为名称，类型，是否必有，备注，Mock或者参考值，删除按钮，新增按钮，这里值得注意的是类型，在DOCLever里面，json的类型有六种：String，Number，Boolean，Array，Object，Mixed，前五种都好理解，最后一种Mixed代表的是任意类型，当我们的参数类型不定的时候，就可以用Mixed来代替。当参数的类型为Array或者Object的时候，我们可以为该字段添加子字段，拖动该字段，我们还可以改变字段的顺序，或者父子关系。<br />
<br />
<img alt="" src="" /><br />
<br />
<strong>RAW:</strong>如果返回的是其他类型的数据，就可以在RAW标签页里面填入相关的信息。<br />
<br />
<img alt="" src="" /><br />
<br />
			</div>
		</div>
	</div>
</div> 
<div class="footer">
	<div class="layui-container" style="text-align: center;">
		<ul>
			<li><a href="http://www.doclever.cn/controller/custom/custom.html">定制化服务</a></li> 
			<li><span>|</span></li> 
			<li><a href="http://www.doclever.cn/controller/about/about.html">关于我们</a></li> 
			<li><span>|</span></li> 
			<li><a href="http://www.doclever.cn/controller/donate/donate.html">支持我们</a></li> 
			<li><span>|</span></li> 
			<li><a href="http://www.doclever.cn/controller/help/help.html">帮助中心</a></li>
			<li><span>|</span></li> 
			<li><a href="http://www.doclever.cn/controller/admin/adminlogin.html">管理总后台</a></li>
		</ul> 
		<p class="tc">©           2016-2017 合肥市胖胖羊信息科技有限责任公司 皖ICP备17002996号</p> 

	</div>  
</div>       
<script src="../style/layui.js" charset="utf-8"></script>
<!-- 注意：如果你直接复制所有代码到本地，上述js路径需要改成你本地的 -->
<script>
layui.use(['element', 'layer'], function(){
  var element = layui.element;
  var layer = layui.layer;
  
  //监听折叠
  element.on('collapse(test)', function(data){
    layer.msg('展开状态：'+ data.show);
  });
});
</script>

</body>
</html>